CHAPTER 2 : Installation Notes |
Note that there is actually only one Visaj build, which will run on any platform. However we have provided easy installers and launchers for specific platforms. The jar distribution is the generic release and should be used for platforms for which we have provided no specific installer/launcher.
A description of what is on the CD-ROM and what is contained in a distribution archive is in Chapter 1 of the Installation and Release notes and in the file README_FIRST on the CD-ROM
Mount the CD-ROM and go to the directory visaj2.4/bin on the CD-ROM. Ensure that you have java in your path and then execute the shell script visaj in that directory:
./visaj
If the installation process does not start automatically then you will have to run the Installshield executable (windows/Visaj2_4.exe) from within windows and then follow the on screen instructions in order to complete the installation.
Also in the mac folder is a BinHex'd Self-extracting archive. Double-clicking on this will install Visaj in a folder 'Visaj 2.4'.
If Visaj fails to start from the main windows interface, start a command prompt and change to the directory where installation took place, by default this is "\program files\ist\visaj". Change directory to the "bin" directory and attempt to run visaj with the -r or -R flag i.e.
visaj -rProblems may be encountered because by default your personal settings on your machine will override any of the options that you configured inside the installation script. This means that if you have a different Java version in your path than that selected inside the installation, it will be overridden. If you do not want your local environment to override then set your VISAJOPTS environment variable to have the -r or -R flag indicating that you wish to use the values Visaj has stored. If Visaj picks up any early versions of Java that have been left in your path it may lead to problems.
Visaj is launched by the shell-script visaj, which is located in <root_dir>/bin, where <root_dir> is the directory into which you installed Visaj. To run Visaj, ensure the bin directory is on your path, and at the command prompt, type:
visaj
To do this, you should put the Visaj JAR file, <root_dir>/visaj.jar, the plugins directory, <root_dir>/lib/plugins, and the Image Editor JAR file, <root_dir>/ImageEditor.jar, on your classpath and then run the following
command:
java -Dvj.rootDir=<root_dir> com.pacist.visaj.AWTClassAppwhere <root_dir> is the path to the directory containing the Visaj release.
The commands to do this can also be incorporated into a batch or command script appropriate to your operating system.
There are two ways of authenticating Visaj:
The details about the Authentication process are in the next section and can also be found in the text file AUTHENTICATION or in the on-line HTML documentation accessible from doc/index.html.
There are special considerations regarding Authentication on the Macintosh. These are documented in the file MAC-README.TXT, which is in the mac folder on the CD-ROM and in the download area on IST's web site.
set CLASSPATH=c:\swing\swingall.jar;%CLASSPATH%On Unix, one of:
setenv CLASSPATH /opt/swing/swingall.jar:$CLASSPATH
CLASSPATH=/opt/swing/swingall.jar:$CLASSPATH export CLASSPATHOn Macintosh:
Place the `swingall.jar' file in the MRJClasses folder, in the MRJ Libraries folder in the Extensions folder (inside the System Folder)You will need to request swing when you start Visaj - see the "Starting Visaj with Swing" section below. Alternatively switch palettes to Swing - see the "Using Swing in Visaj" section below.
Note - JDK 1.2 has now been renamed The Java 2 Platform
Edit the properties of the Visaj shortcut icon (press the right-hand mouse button over it, and select `properties' from the menu which appears)
Choose the `Shortcut' page of the dialog
In the `target' field there will be the path to the visaj.exe file. Append `-swing' to this, click on Apply and close the dialog
This will make Visaj always use swing - to revert, simply remove the `-swing'On Unix
visaj -swingOn Macintosh
Double-click the Visaj-Swing icon to launch Visaj with the Swing components pre-loaded onto the paletteOn others
java -Dvj.rootDir=<root_dir> -Dvj.useSwing=true com.pacist.visaj.AWTClassApp
Ensure that the download completed successfully. The file sizes are given on the web page - ensure that your downloaded file is the same size as indicated on the web page.
If you are having problems accessing the files directly you can copy the files from the CD-ROM to a local file store.
Problems may be encountered because by default your personal settings on your machine will override any of the options that you configured inside the installation script. This means that if you have a different Java version in your path than that selected inside the installation, you will override it. If you do not want your local environment to override then set your VISAJOPTS environment variable to have the -r or -R flag indicating that you wish to use the values Visaj has stored. If Visaj picks up any early versions of Java that have been left in your path it may lead to problems.
Finally, if following the above does not cure your problem, email your Visaj supplier, and quote your Visaj Customer Reference number (of the form ABC1234), making sure you identify the product as Visaj. If your supplier is IST then you should email support@ist.co.uk.